|
Menu location |
---|
Utilities → Layer |
Workbenches |
Draft |
Default shortcut |
None |
Introduced in version |
0.19 |
See also |
Draft AutoGroup, Draft LayerManager |
The Draft Layer command creates a Draft Layer. A layer is a special kind of group with a number of visual properties. These properties, and any changes to them, are propagated to the objects placed inside the layer. The layers themselves are put in another special group: the Draft LayerContainer.
For a Draft LayerContainer these additional options are available in the Tree view context menu:
For a Draft Layer these additional options are available in the Tree view context menu:
If you drop an object from a Std Group, or a group-like object such as an Arch BuildingPart, on a layer in the Tree view, it is not removed from the group, and vice versa. To remove an object from a layer it must be dropped on another layer or on the document node. There is no need to hold down the Ctrl key when dragging from or dropping on a layer.
See also: Property editor.
A Draft Layer object is derived from an App FeaturePython object and inherits all its properties. It also has the following additional properties:
Layer
LinkList
): specifies the objects that are inside the layer.Layer
The properties in this section are applied to objects that are put inside the layer. And any changes to these properties are propagated to them. For two properties, VistaLine Color and VistaShape Color, this behavior is optional.
Enumeration
): specifies the draw style of the layer: Solid
, Dashed
, Dotted
or Dashdot
Color
): specifies the line color of the layer.Float
): specifies the line width of the layer.Bool
): specifies if changes to the VistaLine Color of the layer are propagated to the objects inside the layer.Bool
): specifies if changes to the VistaShape Appearance of the layer are propagated to the objects inside the layer. introduced in version 1.0MaterialList
): specifies the shape appearance of the layer. introduced in version 1.0Color
): specifies the shape color of the layer. It is kept synchronized with the Diffuse Color of the VistaShape Appearance.Percent
): specifies the transparency of the layer. It is kept synchronized with the Transparency of the VistaShape Appearance.Color
): specifies the line print color of the layer.Bool
): specifies if the VistaLine Print Color of the layer is used when a TechDraw DraftView is created from the objects inside the layer.See also: Autogenerated API documentation and FreeCAD Scripting Basics.
To create a Draft Layer use the make_layer
method of the Draft module. To add objects to, or remove objects from, a layer change its Group
property.
import FreeCAD as App
import Draft
doc = App.newDocument()
layer = Draft.make_layer(line_color=(1.0, 0.0, 0.0, 0.0),
shape_color=(1.0, 1.0, 0.0, 0.0))
polygon1 = Draft.make_polygon(5, radius=1000)
polygon2 = Draft.make_polygon(3, radius=500)
polygon3 = Draft.make_polygon(6, radius=220)
layer.Group = [polygon1, polygon2, polygon3]
doc.recompute()